home *** CD-ROM | disk | FTP | other *** search
/ By Popular Request 2.0 / By Popular Request 2.0 (Arsenal Computer).ISO / amiga_5 / spc32020.ads < prev    next >
Text File  |  1995-08-04  |  10KB  |  237 lines
  1.  Amiga Distribution System-- Long Description File
  2.  
  3.            ADS Zone: 1
  4.      ADS Hatch Site: Don Plesky
  5.        ADS Position: ADS Zone 1 Coordinator
  6.            BBS Name: EastPointe Amiga BBS
  7.     Phone Number(s): 810-773-6959
  8.     Network Address: 1:120/229  
  9.      Network Region: 11    
  10.           BBS Hours: 24 Hrs/Day
  11. BBS Mailer/Software: DLG Trapdoor/PDQmail
  12.   BBS Storage Space: 2 Gig 
  13.   File Requestable :  <X> Y     < > N
  14. File Request Hours : All The Time
  15.  
  16. ==========================================
  17.             Long Description
  18. ==========================================
  19.  
  20. Short:        R1.2 of Analog Ckt. Simulator (020/FPU)
  21. Author:       uhenric@mcl.ucsb.edu
  22. Uploader:     uhenric@mcl.ucsb.edu
  23. Type:         misc/sci
  24. Distribution: NoCD
  25.  
  26.  
  27. Spice3f5 Amiga Release 1.2
  28.  
  29. spice3f5r2_000.lha
  30.     Spice with IEEE math for any CPU.
  31. spice3f5r2_020.lha
  32.     Spice with inline FPU math for 020+
  33.  
  34. What is this?
  35.  
  36. This is a full port of Spice3f5.  All device models and analyses in the
  37. 3f5 distribution have been included.  The full simulator has been built,
  38. but the stand-alone "nutmeg" has not (nutmeg is spice without any
  39. simulation capabilities).  "proc2mod" and "multidec" have been included
  40. and seem to generate reasonable output. 
  41.  
  42. The previous version was called "spice3f4", but the patches I had already
  43. applied to it made it identical to 3f5 (with the exception of the patch
  44. number). 
  45.  
  46. What's new?
  47.  
  48. -- CTRL-C works as it should (mostly).
  49.  
  50. -- pz analysis with IEEE math did not work properly.  This was the result
  51.    of a bug in C='s IEEEDPCmp().  I would imagine this could cause other
  52.    problems as well.
  53.     
  54. -- Experimental new pz search method. (I think.  I re-enabled some stuff
  55.    Berkeley had commented out and debugged it.)
  56.     
  57.     
  58. Requirements
  59.  
  60. -- AmigaOS 2 or better.
  61.  
  62. -- A few megs of ram.  (I don't know really.  The full executable is about
  63.    a megabyte.)
  64.  
  65.  
  66. Installation
  67.  
  68. Just decompress it.  It's ready to run.  No silly assigns or anything! 
  69. (Well, maybe add the "bin" directory to you path.  Renaming the binaries
  70. saves some typing as well.)
  71.  
  72. As a quick "getting started" guide, see the file "spice.transcript".
  73.  
  74. If you are tight on memory, try the "lite" version of the executable.  It
  75. does not contain some device models, and the more esoteric analyses are
  76. not supported. 
  77.  
  78. In the 000 archive, there is a patch to the IEEE libraries in the
  79. directory "ieee_fix".  Just follow the the instructions inside.  This is
  80. not included with the 020+ executables, but it's probably a good idea to
  81. fix the problem anyway (the patch is avail. separately on aminet as
  82. "ieee_fix.lha"). 
  83.  
  84. Documentation
  85.  
  86. For spice in general...
  87. Online help is available with the "help" command.  An AmigaGuide version
  88. of the same document can be found in the directory "SpiceGuide" (courtesy
  89. Ron Charlton).  The alias "aghelp" is defined in the initialization file
  90. (lib/scripts/spinit).  It will load the .guide file from the location
  91. specified in the spinit file; see the "spinit" file to set the path to
  92. match your configuration. 
  93.  
  94. The full docs in PostScript format are available by anonymous ftp from
  95. "ic.eecs.berkeley.edu" or "ilpsoft.eecs.berkeley.edu".  This site also
  96. contains more example circuits. 
  97.  
  98. For this port...
  99. There is a plot screen that opens behind your other screens.  The fact
  100. that LAmiga-M/N can be used to flip screens will probably be useful. 
  101.  
  102. I have added a few new variables:
  103.  
  104.    hcopylinewidth -- When this variable is set, PostScript output will
  105.                      contain a "setlinewidth" directive.  This makes 
  106.  
  107.    screenwidth    -- If these are not set, then Intuition will pick some
  108.    screenheight      reasonable values for you.
  109.  
  110.    screendepth    -- If this is not set, then the depth will be copied
  111.                      from the default public screen (Note: Spice will
  112.                      not use more than 20 colors, so I limit the depth
  113.                      copied from the default public screen to 5
  114.                      bit-planes. However, a depth specified in the
  115.                      "screendepth" variable will _not_ be altered in
  116.                      any way; it is passed directly to OpenScreen().)
  117.  
  118.    screenmode     -- This is a hexadecimal number that is passed to 
  119.                      OpenScreenTags() as the DisplayID.  When this 
  120.                      variable is not set, the DisplayID is copied from
  121.                      the default public screen.
  122.  
  123.    fontname       -- Take a wild guess.... like the others if either
  124.    fontheight        or both are not set then defaults will be used
  125.                      (XEN.font/8, if anybody is curious).
  126.  
  127. See the file "lib/scripts/spinit" for more information about these
  128. variables.
  129.  
  130.  
  131. Known problems
  132.  
  133. Spice makes sure that the stack is 64k or greater, but this is not always
  134. enough.  If you have a crash, try setting the stack larger.  If it still
  135. crashes, please send me a copy of the source file. 
  136.  
  137. Repeated uses of "iplot" in the same session seem to have odd results.
  138. Nothing explodes, but the resulting graphs are rather strange at times. 
  139.  
  140. The internal pager could be a little more clever about the size of the
  141. shell window. 
  142.  
  143. There is apparently a bug in OpenScreen that causes the default system
  144. font to be closed when OpenScreen fails.  This is not a problem as long as
  145. the total number of "open" instances of that font is greater than the
  146. number of failed "OpenScreenTags()" calls. 
  147.  
  148.  
  149. Notes
  150.  
  151. The 020+ executables were actually optimized for the 040.  I have been
  152. assured by the SAS folks that the executables will run just fine on the
  153. 68020 and the 68030. 
  154.  
  155. Spice expects some files to be in "progdir:/lib" so if you move files
  156. around, keep this in mind. Some AmigaDOS magic makes "progdir:"  point to
  157. there directory where the program is located. (If spice doesn't find these
  158. files then it will complain, but all should work anyway--except for the
  159. online help).  You can change where the program looks for the help file
  160. with a "set helppath=a:b/c/d".  The "spinit" file is a good place to put
  161. this. 
  162.  
  163. All the executables are "pure" and can be made resident (one must either
  164. use "resident <filename> pure" or set the "p" bit on the executables since
  165. "lha" does not preserve the pure bit); however, if you make spice resident
  166. then "progdir:" does not work.  To get around this problem use the
  167. environment variables (as in "the stuff in ENV:"): 
  168.    setenv SPICE_LIB_DIR "wherever:you/wantyour/lib/dir/to/be"
  169.    setenv SPICE_EXEC_DIR "where:the/spice/executable/is"
  170. There are other environment variables that spice looks for, including:
  171. SPICE_NEWS, SPICE_HELP_DIR (this is another way to deal with the problem
  172. described in the previous paragraph), SPICE_SCRIPTS, SPICE_EDITOR,
  173. SPICE_ASCIIRAWFILE. 
  174.  
  175. If you have the environment variable "HOME" set, then "cd" will change the
  176. current directory to $HOME when given a null argument.
  177.     
  178. And Thanks to...
  179.  
  180. -- SAS for making a great compiler.
  181.  
  182. -- Those of you who have taken the time to write with both compliments and
  183.    complaints.  (Sorry.  No names.  If you really want you name to appear 
  184.    here then contact me; I'm not comfortable identifying anybody without
  185.    their permission. )
  186.  
  187.  
  188. History
  189.  
  190. 1.0 (Initial release)
  191.  
  192. 1.1
  193. -- Added new variable "hcopydevwidth" because PostScript output looked
  194.    like it was drawn with crayons.
  195. -- Updated physical constants to Nov. 86 CODATA Bulletin (not that a couple
  196.    parts per million matter, but the FPU will be using all it's bits anyway,
  197.    so why not?)
  198. -- Commented out all "ScreenToFront()" and "ScreenToBack()" calls.  You have
  199.    to find the plot yourself now, but I think it much less annoying.
  200. -- Fixed a problem with "sourcepath".  The "source" command will now try 
  201.    looking in the current directory.
  202. -- Screen colors are now set to something more reasonable (not perfect yet).
  203. -- Fixed a minor problem with Smith plots.  This required rewriting some
  204.    more of Berkeley's wonderful code.  ...and this led to a little problem in
  205.    my own code... and then to some more in Berkeley's.
  206. -- Plots now use JAM1 instead of JAM2.
  207. -- The "slowplot" variable is not ignored anymore (i.e., it works).
  208. -- New screen variables: "screenwidth", "screenheight", "screendepth", and
  209.    "screenmode"    
  210. -- The current directory is now restored upon exit (if it was ever changed)
  211. -- Added version strings to all executables.
  212. -- Plotting real vectors on polar plots used to fake complex vectors by
  213.    using the real value for both the real and imaginary parts.  The imaginary
  214.    part is now set to zero instead.
  215.  
  216. 1.2
  217. -- Much better CTRL-C handling (other than simply exiting).
  218. -- Fixed a problem with pz searches.  I made the algorithm more robust should
  219.    it screw up; in the process I ran into a bug in the C= IEEE libraries (The
  220.    _real_ cause of the problem.).
  221. -- Fixed a little problem when the screen font and the plot font were not the
  222.    same height.
  223. -- Added variables to control fonts: "fontname" and "fontheight". 
  224. -- "Press return..." prompting now appears on both the plot screen and in the
  225.    console window.
  226. -- Added experimental variable to control pz analysis: "pzniterlim" and
  227.    "pzusesym2".  They don't seem to do much...
  228. -- CR-LF combinations in source files should no longer cause confusion.
  229. -- ASRC model working much better now (Enforcer hits appear to be gone).
  230. -- Fixed Enforcer hit when setting some variables ("program"/"rawfile").
  231. -- Recompiled without "NOVM" flag, yielding much better convergence (at least
  232.    for the ltra examples).
  233.    
  234. Suggestions and Bugs to...
  235.  
  236. Henric Jungheim <uhenric@mcl.ucsb.edu>
  237.